home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / MIDTOOLS / MDF.DOC < prev    next >
Text File  |  1994-04-27  |  8KB  |  187 lines
  1.  
  2.  
  3.           MIDI DATA FILER ver 3.2, April 1994 by Kai Risku
  4.           ================================================
  5.  
  6. This is a very easy-to-use program that will send and receive midi sysex
  7. dumps on a PC. The dumps are stored as raw files and are compatible with
  8. sysex dumps used by most sequencing programs. The dumps can be several
  9. hundred kilobytes in size (limited by available memory).
  10.  
  11. The program requires a MPU-compatible midi interface and can be
  12. configured for any base address (interrupts are not used at all).
  13.  
  14.  
  15. How to save MIDI-data to a file:
  16. ================================
  17.  
  18. You just start MDF with a non-existent filename as argument. When MDF
  19. reports 'Start dump' you can start a sysex-dump manually from your
  20. synthesizer or press any key to abort. A dot will be displayed for every
  21. sysex block received (so you can see that the computer is actually
  22. getting some data).
  23.  
  24. After the dump is done, MDF will report how many bytes have been
  25. received, save those in the file you specified and exit automatically.
  26.  
  27. The amount of data you can receive is limited by the available memory
  28. below 640k (minus about 40k for MDF itself).
  29.  
  30.  
  31. How to send the data back to the synthesizer:
  32. =============================================
  33.  
  34. Oh, you have already guessed that one, but I just want to say it anyway.
  35. Run MDF with the name of the file you want to send to your synthesizer
  36. as the argument. MDF will send the contents of the file and inform you
  37. of how many bytes has been sent. You can press ESC if you wish to abort
  38. the transfer.
  39.  
  40.  
  41.  
  42. Configuring MDF using the MDF.INI file:
  43. =======================================
  44.  
  45. When starting up MDF, the program will look for a file named MDF.INI in
  46. the same directory as MDF.EXE is in. If the INI-file cannot be found,
  47. one will be created using some default values. The file is in plain
  48. ASCII format and can be edited with any ascii editor. These are the
  49. valid options and what they specify:
  50.  
  51. Delay1=n
  52.  
  53.         where n is a decimal integer specifying the delay between
  54.         each byte sent. A larger value means slower sending.
  55.  
  56. Delay2=n
  57.  
  58.         where n is a decimal integer specifying a delay in
  59.         milliseconds between each sysex block sent.
  60.  
  61. Timeout=n
  62.  
  63.         where n is a decimal integer in milliseconds specifying how
  64.         long MDF should wait for more data before finishing.
  65.  
  66. Extension=ext
  67.  
  68.         where ext is a filename extension with a maximum of three
  69.         characters. This extension will be used if MDF is invoked
  70.         with a filename with no extension. If this option is
  71.         missing, the default extension will be SYX. Using filenames
  72.         with no extension at all requires either a period after the
  73.         filename on the command line, or removing the characters to
  74.         the right of the equal sign in MDF.INI.
  75.  
  76. Port=addr
  77.  
  78.         where addr is the address of the midi interface. The address
  79.         can be given in decimal or hex. To specify hex mode, you
  80.         must either have '0x' before the address, or the character
  81.         'h' after. The default address can be written these ways;
  82.         Port=816, Port=0x330 or Port=330h
  83.  
  84. SysexOnly=boolean
  85.  
  86.         where boolean is one of '1', '0', 'True', 'False', 'Yes' or
  87.         'No' (only the first character is used and case is not
  88.         significant). This setting controls if all incoming data
  89.         should be put in the file, or only proper sysex data (only
  90.         data between sysex start and end markers). This option is by
  91.         default set to True, but you can change it if you want to
  92.         save other than sysex data to a file.
  93.  
  94.  
  95. If it does not work:
  96. ====================
  97.  
  98. - If your MPU-compatible interface is not installed on the default
  99.   port address 330h, you must set the correct address in MDF.INI.
  100. - some synthesizers can choke if the computer dumps data too fast.
  101.   Increase the delays specified in MDF.INI to slow down the sending.
  102. - There can be some problems when receiving a dump if the
  103.   synthesizer dumps data too fast and you have a slow computer.
  104.   You should therefore keep an eye on the size of the received data
  105.   as this will be too small if data has been lost (or the dump may
  106.   vary in size, depending on the phase of the moon and other
  107.   non-obvious factors).
  108. - You cannot use handshake-dumps with this program, because
  109.   practically every synth has its own format for this. Make sure
  110.   that you start a one-way dump from your synthesizer.
  111.  
  112.  
  113. Revision history
  114. ================
  115.  
  116. New in version 3.2:
  117.         Added option to filter out any data not enclosed in a proper
  118.         sysex-format (enclosed by 0xF0 and 0xF7).
  119. New in version 3.1:
  120.         Fixed bug that occasionally saved some garbage at the
  121.         end of the file when receiving. Tweaked the documentation.
  122. New in version 3.0:
  123.         Sysex dumps are no longer limited to 64 kbytes. Receiving
  124.         sysex data is only limited by your dos memory (below 640k).
  125.         The receive timeout can now be specified in MDF.INI.
  126.         Program selfcheck added and large portions of the code
  127.         rewritten to improve the program in several ways.
  128. New in version 2.6:
  129.         The address of the midi interface can be set in MDF.INI
  130. New in version 2.5:
  131.         You can now change the default filename extension
  132.         using MDF.INI
  133. New in version 2.4:
  134.         Ctrl-C is now trapped, so you cannot break out of the
  135.         program and leave the midi interface in UART mode.
  136. New in version 2.3:
  137.         Added an INI-file for user-configurable delays while
  138.         sending. Modified text output and removed some
  139.         unnecessary texts.
  140. New in version 2.2:
  141.         More code cleanup. Incoming data during sysex-send
  142.         to synthesizer will be sent back out when possible.
  143.         Error-handling improved.
  144. New in version 2.1:
  145.         The default extension MDF for files created was changed
  146.         to SYX for compatibility with other software.
  147.         Active sensing has earlier caused some trouble, but
  148.         this has now been fixed as well as a small bug causing
  149.         a time-out if you don't start the dump fast enough
  150.         after you started the program.
  151. New in version 2.0:
  152.         Document added (this piece of text). Improved routines
  153.         with faster code. Corrected some minor bugs. This was
  154.         the first "official" release.
  155.  
  156.  
  157.  
  158. #include <std_disclaimer.h>:
  159. ============================
  160.  
  161.                 Copyright (c) 1990-1994 Kai Risku
  162.  
  163. MDF is offered to you "AS IS" without any warranty. This software has
  164. been thoroughly tested but no guarantee is given that it will work on
  165. every computer. The copyright owner may not be held liable for any
  166. damages, direct or consequential, which may result from the the use of
  167. this program.
  168.  
  169. This program is freely distributable. You may use the software and
  170. share it with all your friends (and foes) as long as the program is
  171. supplied in its original, unmodified form, which includes this
  172. documentation. This program must not be distributed for profit.
  173.  
  174. If you have any questions, ideas, suggestions for improvements or if
  175. you are interested in the source then feel free to contact me...
  176.  
  177. A short email or a postcard would be appreciated as it tells me how
  178. MDF is spread around the world as well as the fact that someone is
  179. actually using my program!
  180.  
  181.  
  182. Snailmail:      Kai Risku         Email (internet):  Kai.Risku@hut.fi
  183.                 Kronvik                
  184.                 65410 Sundom           Email strongly preferred!!!
  185.                 Finland
  186.  
  187.